home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / mq_close.z / mq_close
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. mmmmqqqq____cccclllloooosssseeee((((3333cccc))))                                                      mmmmqqqq____cccclllloooosssseeee((((3333cccc))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _mmmm_qqqq______cccc_llll_oooo_ssss_eeee - close a message queue descriptor
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_mmmm_qqqq_uuuu_eeee_uuuu_eeee_...._hhhh_>>>>
  13.  
  14.      _mmmm_qqqq_dddd______tttt _mmmm_qqqq______cccc_llll_oooo_ssss_eeee _((((_mmmm_qqqq_dddd______tttt _m_q_d_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _mmmm_qqqq______cccc_llll_oooo_ssss_eeee closes the connection between message queue descriptor, _m_q_d, and
  18.      its associated queue. The descriptor, _m_q_d, should have been obtained from
  19.      a prior call to _mmmm_qqqq______oooo_pppp_eeee_nnnn(3c). No messages are added or removed from the
  20.      queue.
  21.  
  22.      If multiple threads within a common process (i.e., sprocs, pthreads) are
  23.      sharing _m_q_d, a single call to _mmmm_qqqq______cccc_llll_oooo_ssss_eeee will close the message queue for
  24.      all threads within the calling process.
  25.  
  26.      If the process has a notification request attached [see _mmmm_qqqq______nnnn_oooo_tttt_iiii_ffff_yyyy(3c)] to
  27.      the queue, the notification request is removed and the queue is available
  28.      for attachment of a notification request.
  29.  
  30.      If this is the last queue descriptor associated with the queue and the
  31.      queue has been unlinked [see _mmmm_qqqq______uuuu_nnnn_llll_iiii_nnnn_kkkk(3c)] earlier, the message queue
  32.      will be removed.
  33.  
  34.      _mmmm_qqqq______cccc_llll_oooo_ssss_eeee will fail if one or more of the following conditions are true:
  35.  
  36.      [EBADF]        The message queue descriptor, _m_q_d, is not valid.
  37.  
  38.      [EINTR]        A signal interrupted the _mmmm_qqqq______cccc_llll_oooo_ssss_eeee function call.
  39.  
  40. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  41.      _mmmm_qqqq______oooo_pppp_eeee_nnnn(3c), _oooo_pppp_eeee_nnnn(3c), _iiii_nnnn_tttt_rrrr_oooo(3c), _mmmm_qqqq______uuuu_nnnn_llll_iiii_nnnn_kkkk(3c), _mmmm_qqqq______rrrr_eeee_cccc_eeee_iiii_vvvv_eeee(3c),
  42.      _mmmm_qqqq______ssss_eeee_nnnn_dddd(3c), _mmmm_qqqq______gggg_eeee_tttt_aaaa_tttt_tttt_rrrr(3c), _mmmm_qqqq______ssss_eeee_tttt_aaaa_tttt_tttt_rrrr(3c), _mmmm_qqqq______nnnn_oooo_tttt_iiii_ffff_yyyy(3c)
  43.  
  44. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  45.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  46.      of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.